System.onStatus

Доступность

Flash Player 6.

Синтаксис

System.onStatus = function(InfoObject:Object) {
  // ваши инструкции
}

Описание

Обработчик события: выполняет роль обработчика "надсобытия" для некоторых объектов.

LocalConnection, NetStream, и SharedObject классы имеют обработчик onStatus, который использует цель для обработки информации, состояния, сообщений об ошибке. Чтобы реагировать на это событие, вы должны создать функцию, обрабатывающую цель и также должны знать формат и содержимое, возвращаемого целью.

В дополнение к этим методам onStatus, Flash также имеет "надобработчик"System.onStatus, который служит вторичным обработчиком сообщения об ошибках. Если экземпляру класса LocalConnection, NetStream, или SharedObject передаётся от некоторой цели значение свойства level как “error”, но вы не определили функцию onStatus для этого экземпляра, тогда Flash использует функцию, которую вы определили как System.onStatus.

Примечание: Классы Camera и Microphone также имеют обработчик onStatus , однако от цели не передаётся свойство level как "error". Поэтому, System.onStatus не вызывается; вам необходимо определить отдельную функцию для обработки этих событий.

Пример

В следующем примере показано, как созданная функция System.onStatus, обрабатывает сообщение об ошибке, когда, определённая классом функция onStatus, отсутствует :

// Создаётся универсальная функция
System.onStatus = function(genericError:Object){
  // Ваш сценарий сделал бы кое-что более значимое здесь
  trace("An error has occurred. Please try again.");
}

В следующем примере показано, как создаётся функция onStatus для экземпляра класса NetStream :

/ Создаём функцию для объекта NetStream 
videoStream_ns.onStatus = function(infoObject:Object) {
  if (infoObject.code == "NetStream.Play.StreamNotFound") {
    trace("Could not find video file.");
  }
}

См.также

Camera.onStatus, LocalConnection.onStatus, Microphone.onStatus, NetStream.onStatus, SharedObject.onStatus

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление